#! /usr/bin/env perl
##
## Copyright (C) by Argonne National Laboratory
##     See COPYRIGHT in top-level directory
##

# Create an index of web pages for MPICH
#
# Default values
# Root for the pages
$WWWRoot=`pwd`;
chop $WWWRoot;
# Base address (installation address)
# $URLBase = "http://";
# End of line character (\r\n is DOS-friendly)
$eol = "\r\n";
# Number of columns in table of names
$TableCols = 3;
#
# Process arguments for any changes
foreach $_ (@ARGV) {
    if (/-?(-[^=]*)=(.*)/) {
	$argname = $1;
	$argval  = $2;
    }
    else {
	$argname = $1;
	$argval  = "";
    }
    if ($argname =~ /-wwwroot/) {
	$WWWRoot = $argval;
    }
    elsif ($argname =~ /-urlbase/) {
	$URLBase = $argval;
    }
    elsif ($argname eq "-help") {
	print STDOUT "createhtmlindex [ -wwwroot=directory ] [ -urlbase=base ]\n";
	print STDOUT "Build the www index pages for MPICH.";
	print STDOUT "This must be run in the root of an MPICH tree; it may\n
be run in a VPATH directory after configuring.\n";
	exit 1;
    }
    else {
	print STDERR "Unknown argument $_\n";
	exit 1;
    }
}

# Create the main index
open( OUTFD, ">$WWWRoot/www/index.html" ) ||
    die "Cannot open $WWWRoot/www/index.html\n";

&AddHeader( "Web pages for MPI" );

print OUTFD "<H2>MPI Commands</H2>$eol";
&AddDirectoryContents( "www", "www1" );

print OUTFD "<H2>MPI Routines and Constants</H2>$eol";
if (-f "www/www3/mpi.cit") {
    &createRedirects("www/www3", "mpi.cit");
}
else {
    print STDERR "Could not find mapping file\n";
}
&AddDirectoryContents( "www", "www3" );

#print OUTFD "<H2>MPE Routines</H2>$eol";
#&AddDirectoryContents( "www", "www4" );

&AddTrailer( );

close( OUTFD );

# Create the sectional indices
open( OUTFD, ">$WWWRoot/www/www1/index.htm" ) ||
    die "Cannot open $WWWRoot/www/www1/index.htm\n";

&AddHeader( "Manpages for MPICH" );
&AddDirectoryContents( "www/www1", "." );
&AddTrailer( );
close( OUTFD );

open( OUTFD, ">$WWWRoot/www/www3/index.htm" ) ||
    die "Cannot open $WWWRoot/www/www3/index.htm\n";

&AddHeader( "Web pages for MPI Routines and Constants" );
&AddDirectoryContents( "www/www3", "." );
&AddTrailer( );
close( OUTFD );

# open( OUTFD, ">$WWWRoot/www/www4/index.htm" ) ||
#     die "Cannot open $WWWRoot/www/www4/index.htm\n";

# &AddHeader( "Web pages for MPE Routines" );
# &AddDirectoryContents( "www/www4", "." );
# &AddTrailer( );
# close( OUTFD );


0;
# ---------------------------------------------------------------------------
# Support routines.
# All write to OUTFD and use $eol for end-of-line
# ---------------------------------------------------------------------------
sub AddHeader {
    my $title = $_[0];
    print OUTFD "<HTML>$eol<HEAD>$eol<TITLE>$title</TITLE>$eol";
    print OUTFD "<!-- This file generated by createhtmlindex on $date -->$eol";
    print OUTFD "</HEAD>$eol<BODY BGCOLOR=\"FFFFFF\">$eol";
    print OUTFD "<H1>$title</H1>$eol";
}

sub AddTrailer {
    print OUTFD "</BODY>$eol</HTML>$eol";
}

# For the items (mostly MPI constants) that are within a single web page,
# create a redirect page for them.  This allows us to point to a location
# on the page, rather than just a page which is what a file link would
# accomplish
sub createRedirects {
    $rootdir = $_[0];
    $mapfile = $_[1];
    open( MAPFD, "<$rootdir/$mapfile" ) || die "Cannot open map file $mapfile\n";
    while (<MAPFD>) {
	@fields = split(/\+/);
	$name = $fields[1];
	$url  = $fields[8];
	if ($url =~ /(.*)\/([^\/]*)\.([HTMLhtml]*)#(.*)/) {
	    $rooturl  = $1;
	    $basefile = $2;
	    $ext      = $3;
	    $anchor   = $4;
	    if ($basefile ne $anchor) {
		open(RFD, ">$rootdir/$anchor.htm") || die "Cannot open redirect file $anchor.htm\n";
		print RFD "<html><head><meta http-equiv=\"refresh\" content=\"0; url=$basefile.$ext#$anchor\" /></head></html>\n";
		close RFD;
	    }
	}
	else {
	    print STDERR "Could not decode $url\n";
	}

    }
    close MAPFD;
}

# Take all .htm and .html files and add them to the OUTFD file.
# This works in two steps:
# 1. Read and sort the contents of the directory into the array
# @HTMLFiles
# 2. Use the routine MakeHTMLTable to create a table with a given
# number of columns, adding the links within the columns
@HTMLFiles = ();
# Look in $1/$2 for files, but make links relative to $2
sub AddDirectoryContents {
    my $rootdir = $_[0];
    my $dirname = $_[1];

    # 1 Read the files
    @HTMLFiles = ();
    opendir DIR, "$rootdir/$dirname";
    if ($dirname eq ".") {
	$prefixname = "";
    }
    else {
	$prefixname = "$dirname/";
    }
    while ($filename = readdir DIR) {
	if ($filename =~ /index\.html?/) { next; }
	if ($filename =~ /.*\.html?$/) {
	    $HTMLFiles[$#HTMLFiles+1] = "$prefixname$filename";
	}
    }
    closedir DIR;

    @HTMLFiles = sort( @HTMLFiles );

    # Format the table
    &MakeHTMLTable;
}
# MakeHTMLTable takes an array of items and turns them into a table with
# $TableCols columns.
#
sub MakeHTMLTable {
    my $nvals = $#HTMLFiles;

    my $nrows = int ( ($nvals + $TableCols - 1) / $TableCols );
    print OUTFD "<TABLE>$eol";
    for ($j=0; $j<$nrows; $j++) {
	print OUTFD "<TR>";
	for ($e=0; $e<$TableCols; $e++) {
	    $filename = $HTMLFiles[$j + $e * $nrows];
	    $linkname = $filename;
	    $linkname =~ s/\.html?//;
	    $linkname =~ s/.*\///;
	    if ($filename ne "") {
		$line = "<A HREF=\"$filename\">$linkname</A>";
	    }
	    else {
		$line = "";
	    }
	    print OUTFD "<TD>$line</TD>$eol";
	}
	print OUTFD "</TR>$eol";
    }
    print OUTFD "</TABLE>$eol";
}
